<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta http-equiv="Content-Type"
 content="text/html; charset=iso-8859-1">
  <meta name="GENERATOR" content="Mozilla 1.1 under Linux">
  <title>TiEmu User's Manual</title>
  <meta name="author" content="The TiEmu team">
  <meta name="description" content="User's Manual">
</head>
<body style="background-color: rgb(255, 255, 255);">
<div align="center">
<div style="text-align: left;">
<div class="NAVFOOTER">
<hr align="left" width="100%">
<table summary="Footer navigation table" border="0" cellpadding="0"
 cellspacing="0" width="100%">
  <tbody>
    <tr>
      <td align="left" valign="top" width="33%"><a href="chapter05.html"
 accesskey="P">Prev</a></td>
      <td align="center" valign="top" width="34%"><a
 href="Manual_en.html" accesskey="H">Home</a></td>
      <td align="right" valign="top" width="33%"><a
 href="chapter07.html" accesskey="N">Next</a></td>
    </tr>
    <tr>
      <td align="left" valign="top" width="33%">Keyboard mapping</td>
      <td align="center" valign="top" width="34%">&nbsp;</td>
      <td align="right" valign="top" width="33%">Debugger<br>
      </td>
    </tr>
  </tbody>
</table>
<hr align="left" width="100%">
</div>
</div>
</div>
<h1>6. Popup menu</h1>
By clicking the right button menu anywhere on the main window, you gain
access to the functionnalities of the emulator. If you let your mouse
cursor on the item during some while, a tooltip will appear.<br>
On iPAQ, you have to touch-point on the LCD region.<br>
<br>
The menu
is organized as follow :<br>
<div style="text-align: center;"><img alt="" src="popup_menu.png"
 style="width: 191px; height: 323px;"><br>
</div>
<br>
<h2>6.1 Link </h2>
The <span style="font-style: italic;">Send file to TiEmu</span> item
will let you choose a file to load into the emulator while being on the
HOME screen. You can choose
one or several files at a time. You can drag and drop them from
anywhere to the&nbsp; TiEmu main windows, too.<br>
<br>
The <span style="font-style: italic;">Debug file with TiEmu</span>
item
will let you choose a file to debug using the emulator: First, the file
(which should be an uncompressed TIGCC program compiled with debugging
information) will be loaded into the emulator and a program entry
breakpoint will be set on it. You then need to run the program, passing
any arguments it requires. TiEmu will then intercept the launch, bypass
any OS execution protections (so you need not worry about these), open
the debugger and load the debugging information file (the .dbg file
corresponding to your program, and looked up in the same folder as your
program). It will also set a GDB breakpoint on the main function, so if
you don't need to debug the TIGCC startup code, just click "Continue"
in the Insight Source Window to get to the beginning of your main
function. You can choose only one file at a time; any data files
required by the program need to be sent separately using
<span style="font-style: italic;">Send file to TiEmu</span>.<br>
<br>
The <span style="font-style: italic;">Settings</span> item opens a
dialog box. This is a large topic which is covered elsewhere. See the
corresponding
section...<br>
<br>
The <span style="font-style: italic;">Quick send...</span> item
is a convenient feature when testing program being under development.
It allows to specify a file to send whenever you press F10 or click the
<span style="font-style: italic;">Send file to TiEmu</span> item.<br>
When enabled, the dialog box displayed by <span
 style="font-style: italic;">Send file</span> is completely by-passed.<br>
<br>
The <span style="font-style: italic;">Listen for files</span> item
lets
you
enable (checked) or disable (unchecked) the receiving of variables
from TiEmu. You should uncheck it if your program accesses the linkport
for sound.<br>
<br>
<span style="font-style: italic;">Emulate Sound</span> enable sound
emulation to speakers. Check it if your program accesses the linkport
for sound.<br>
<h2>6.2 Configuration and State</h2>
You can save or load a particular configuration. A configuration
contains the current parameters of the emulator (emulator image to use,
size of the window, link cable type, ...). It does not contain any
information on the calculator state. The configuration is saved in the
<span style="font-style: italic;">tiemu.ini</span> file. This is a text
file and its format is described in the command line section.<br>
<br>
The calculator state can be saved, loaded or reverted (automatically
load the last previously saved state). <br>
This can be done at any time. The revert option is useful to reload the
latest saved state.<br>
<br>
The state is
saved in a file containing an image of the calculator content (UAE
structures of the m68k engine, I/O ports, RAM, RTC, FLASH, LCD address,
contrast, HW protection state, archive limit, ...) and of some
environmental variables (all breakpoints).<br>
<h2>6.3 Debugger</h2>
This is a large topic which is covered elsewhere. See the corresponding
section...<br>
<br>
<span style="font-style: italic;">Reset calc</span>: this completely
resets the calculator by loading the RESET/SSP vectors and issuing a
reset of the processor. The linkport is reset, too. Other devices
(ASIC, RAM, FLASH, ...) are left un-touched.<br>
This is not like you removed batteries
for a while.<br>
<br>
<span style="font-style: italic;">Upgrade calc</span>: allows you to
load a TI's OS FLASH upgrade into the calculator without needing to
send it. If you save the calculator state, TiEmu will remind the
upgrade and load it after image at startup.<br>
<h2>6.4 Options</h2>
<span style="font-style: italic;">Set ROM version</span>: lets you
choose an existing image from a list. If you want to add an image,
click the <span style="font-style: italic;">Import</span> button to
convert a ROM dump or a FLASH upgrade into an image. <br>
You can drag and drop a ROM dump or FLASH upgrade onto the TiEm main
window. The file will be automatically imported and you will get the
box below.<br>
Note: TiEmu scans the <span style="font-style: italic;">images</span>
folder whenever you run this box.<br>
<br>
<div style="text-align: center;"><img alt="" src="romversion.png"
 style="width: 328px; height: 274px;"><br>
</div>
<br>
<span style="font-style: italic;">Misc options</span>: <br>
- <span style="font-style: italic;">restrict to actual speed</span>:
if checked, TiEmu will run the hand-held at its nominal speed. Else, it
will run it at the maximum the CPU is capable of.<br>
- <span style="font-style: italic;">HW protection</span>: if checked,
the HW protection device is enabled and emulated. TiEmu needs to be
restarted (or an image to be loaded) for changes to take effect.<br>
<br>
- <span style="font-style: italic;">normal view</span>: display skin
and/or lcd with a 1x ratio,<br>
- [Win32] <span style="font-style: italic;">large view</span>: same
with 2x
ratio (note: this mode will use more CPU),<br>
- [Linux] <span style="font-style: italic;">large view</span>: same
with 2x
ratio (note: the skin may not be resized to 2x with some WM, it will be
resized to fit the screen),<br>
- <span style="font-style: italic;">full screen</span>: display LCD
only and make it fits the screen (currently disabled because it is
excessively CPU intensive under Win32).<br>
<br>
<span style="font-style: italic;">Skin for current calc</span>: <span
 style="font-style: italic;">none</span>, <span
 style="font-style: italic;">default</span>, <span
 style="font-style: italic;">other</span>. <br>
The first option lets you remove the skin to just display the LCD. In
this mode, you keep access to the right click menu but you have to use
the keyboard for TI keys:<br>
<br>
<div style="text-align: center;"><img alt="" src="no_skin.png"
 style="width: 248px; height: 162px;"><br>
</div>
<br>
The second option makes TiEmu fall back on the built-in skin. <br>
The third option lets you choose a skin of your own. You can drag and
drop a skin file to the&nbsp; TiEmu main windows, too.<br>
Note: the skin must be a TiEmu
compatible skin (see the Skin section) else it will be rejected.<br>
<h2>6.5 Infos</h2>
<span style="font-style: italic;">Misc</span>: gives you access to this
help and ManPage, ChangeLog, About.<br>
<br>
<span style="font-style: italic;">Info</span>: enumerates current
calculator information like this:<br>
<br>
<div style="text-align: center;"><img alt="" src="calc_infos.png"
 style="width: 265px; height: 236px;"><br>
</div>
<br>
<h2>6.6 Exiting</h2>
<span style="font-style: italic;">Exit and save state</span>: TiEmu
will save both <span style="font-weight: bold;">state</span> and <span
 style="font-weight: bold;">configuration</span> before exiting.<br>
<br>
<span style="font-style: italic;">Exit without saving state</span>:
TiEmu will exit <span style="font-weight: bold;">without</span> saving
state and configuration.<br>
<br>
<hr>
</body>
</html>
